home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / bbsutil / filsl11.zip / FILSLUTH.DOC < prev    next >
Text File  |  1990-03-05  |  16KB  |  379 lines
  1.  
  2.  
  3.  
  4.                                                     March 5, 1990
  5.  
  6.                            File Sleuth   v1.1
  7.  
  8.                            Copyright (C) 1990
  9.  
  10.                            By Derrick Burgess
  11.  
  12.  
  13.  
  14.  
  15.          Purpose:
  16.                  Search a list of files and then display a list of
  17.                  all matches to user specified string.  Including AND
  18.                  and OR logic.
  19.  
  20.  
  21.          (This program compatible with allfiles lists from most
  22.           major BBS programs - While PCBoard is the intended
  23.           program supported, many others are supported such as
  24.           Wildcat!, QuickBBS, Pheonix, Gap, etc...  It also is ideal
  25.           for searching BBS phone number lists that include information
  26.           about each board...You could then search for your type of 
  27.           modem, bbs software and location all in one search)
  28.  
  29.  
  30.    I'm sure you're aware of how to find files of interest when you log 
  31.    onto PCBoard Bulletin boards.  One of the best and easiest ways to 
  32.    find files is with the Zippy scan feature of PCBoard.  What this does 
  33.    is scan the file lists for a matching string and then display all the 
  34.    files with the search string in them.  The disadvantage to this type 
  35.    of search is that it 1) Must be done online, and 2) Can be quite slow 
  36.    if the bbs is not running on a '386 machine.  There is a way to do a 
  37.    scan for files offline, and this requires that you download and 
  38.    Allfiles list from the bbs.  Most bbs's have this list available as a 
  39.    Zip file or Self-Extracting Zipfile.  The disadvantage to these files 
  40.    is that once you get this file, there is not a very good way to 
  41.    search it.  Oh, there are many workarounds such as Norton's Text 
  42.    Search, but that only shows a few lines and could even miss the 
  43.    filename or the entire description. Many use a text editor, a text 
  44.    editor comes very close to being ideal for this type of scan except 
  45.    for a couple of serious drawbacks, which are if the allfiles list is 
  46.    larger than available memory, or if you would like to see all the 
  47.    matches one screen.  Which brings us to the point of FileSluth.
  48.  
  49.    FileSluth was written to overcome all the drawbacks of the offline 
  50.    Scan for files and include many features that enhance the use of such 
  51.    a program.  Some of the reasons that make FileSleuth the only way to 
  52.    zippy scan offline are
  53.  
  54.                   1)   Faster than the PCBoard implementation
  55.                   2)   Handles multi-line Prodoor descriptions
  56.                   3)   Allows multi search strings (ie. ARC and ZIP
  57.                        in the same description)
  58.                   4)   Allows wildcards to search several files
  59.                        (such as *.LST or C:\BBS\*.LST)
  60.                   5)   Can keep a log of the search to either a file
  61.                        or the printer.  If the log file exists, the
  62.                        log is appended to
  63.                   6)   Can be run in automatic mode, just specify a
  64.                        string on the command line and the default bbs
  65.                        list and defaul log file are used with no
  66.                        prompt for input from the user.
  67.                   7)   Can change the default bbs file permanently
  68.                        to the directory and files that you want to 
  69.                        search.
  70.                   8)   Can change the default log file permanently
  71.                        from no log to a file or back to no log.
  72.                   9)   Handles file description lines that are greater
  73.                        than 80 characters.  Some bbs programs/sysops do
  74.                        not include a return at the end of each line and 
  75.                        wrap to the next line, this is supported.
  76.                  10)   You can Abort a scan at any time
  77.                  11)   You can Skip a file if you change your mind 
  78.                        during a search that includes wildcards (* or ?)
  79.                        in the filename.
  80.  
  81. ------------------------------------------------------------------------
  82.  
  83.  
  84.    When you run it, it comes up with these possibilities.
  85.  
  86.        Z  Zippy Scan           B  Choose BBS list(s) to search
  87.                                T  Tag BBS list(s) to search
  88.        X  Exit                 L  Choose Log File ''
  89.               Search File(s):  'ALLFILES.LST'
  90.  
  91.    If you want to scan the search BBS list, just hit Z and you will be 
  92.    asked the text to search for. 
  93.  
  94.    B  Choose BBS list
  95.  
  96.        If you do not want to use the Default BBS list, but want a 
  97.        different one, hit B and you will be asked for a new filename.
  98.        
  99.        The filename can be any valid DOS name, and can include 
  100.        wildcards, or be a Response File.
  101.        
  102.        --------
  103.        @ Response File:
  104.              Another way to specify which files to search.
  105.                   The @ response list
  106.  
  107.              This is a file that you create that contains a list of the files
  108.              that you would like to search, one file per line including drive, 
  109.              directory and extension.  This file can be created with a text editor or 
  110.              in DOS by...
  111.  
  112.              C>Copy con Srch.Lst
  113.              \bbs\Grinder.Lst
  114.              \bbs\Lunacy.Lst
  115.              b:Offline.Lst
  116.              ^Z (Control-Z)
  117.  
  118.              1 File(s) Copied is the reply you should get if it worked, now to use 
  119.              this list instead of wildcards or a single file, you need to always 
  120.              precede it with a @ so you will be searching @Srch.Lst.
  121.        ---------
  122.  
  123.    T  Tag Files to search
  124.  
  125.        Similar to B Choose file to search, but this allows you tag only
  126.        a few files to search. It will ask for a drive and subdirectory,
  127.        such as C:\BBS    but you may also add a mask to the end to use just
  128.        your allfiles lists to tag if you want  C:\BBS\*.LST
  129.  
  130.        Does not work with a @ response file.
  131.  
  132.        All instructions on how to tag files are shown onscreen when they can
  133.        be used.
  134.  
  135.    Z  Zippy Scan
  136.  
  137.    You are asked what you want to search for, this can be any string
  138.    containing any characters except &, |, and ~ which are special
  139.    commands to filsluth.
  140.  
  141.    The ~ character should be used anytime that you want to search for 
  142.    a space....If you want to search for a word and do not want it to 
  143.    be inside another, you can put leading and trailing ~ on it.
  144.          ie.  ~ARC~ will find only descriptions with ARC but not those
  145.          such as arcade, arcmaster, narc, etc....
  146.  
  147.       You can do multiple searches at one time by combining strings with 
  148.       the & and | commands
  149.  
  150.             The & (AND) command specifies that both strings must be 
  151.             found....  ie...  ARC & ZIP  searches for both ARC and ZIP 
  152.             in the same File description
  153.             
  154.             The | (OR) command specifies that either of the strings 
  155.             around it are okay, but both are not necessary.
  156.                        ie.... CONVERT & ZIP | ARC | LZH
  157.             would find any strings with the combination of Convert and 
  158.             Zip, Convert and Arc, Convert and Lzh or any combination of
  159.             Zip, Arc, and Lzh.  
  160.  
  161.             One note:  the | cannot be the first command, & must!  There 
  162.                        must be one definite string first, but after that 
  163.                        you can mix & and | as much as you wish.
  164.                        
  165.                   CONVERT & ZIP | ARC | LZH & ~01- | ~02- & -88 | -89
  166.                      Convert And (Zip or Arc or Lzh) dated January or
  167.                      February of either 1988 or 1989
  168.  
  169.         Note:  It is always best to put the least found string FIRST as the
  170.                program searches for the first string, and then only displays
  171.                the program if the rest of the search string is also found.
  172.  
  173.       Another note on the Zippy scan used by FileSleuth.  The search is
  174.       generally faster than that used by PCBoard.  The reason for this is that
  175.       the program assumes that